home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr47 / altqb553.zip / READ.ME < prev    next >
Text File  |  1993-05-08  |  8KB  |  166 lines
  1.  
  2.      Assembly-Language Toolbox for QuickBASIC and VisualBASIC DOS
  3.      ────────────────────────────────────────────────────────────
  4.  
  5.                          By Christy Gemmell
  6.  
  7.  
  8. The fifth edition of the Assembly-Language Toolbox has many new features.
  9. EMS support has been added with a full set of routines for reading and
  10. writing to LIM 3.2/4.0 Expanded Memory. Other routines enable you to
  11. control the DOS print spooler and, thanks to Neil Carter, it now has a
  12. complete set of Mouse functions.
  13.  
  14. High-resolution graphics, a previously neglected area in the Toolbox, have
  15. at last been tackled and this release provides facilities for scrolling,
  16. panning, and controlling the intensity of graphics displays. The routines
  17. for loading and saving high-resolution screens to disk files have been
  18. rewritten in pure assembly-language and are, consequently, much smaller
  19. and faster. In addition I have added routines for drawing and scaling
  20. high-resolution text in any combination of colours that your video card is
  21. capable of displaying. This includes computers fitted with CGA, MCGA, EGA
  22. and VGA adaptors. Hercules graphics cards are not, as yet, supported.
  23.  
  24. Version 5.50 adds a few new requested features; DOSBOX which allows you
  25. to SHELL and run DOS commands in a window is particularly popular. There
  26. are also routines to redirect output from a SHELLed program to the printer
  27. or a file, to stuff up to fifteen keystrokes into the keyboard typeahead
  28. buffer, to locate the DOS master environment and to find the pathname of
  29. the currently executing program.
  30.  
  31. As in previous releases, two versions of the Toolbox library are included.
  32. The first, ALTQUICK.LIB, is intended for linking with stand-alone programs
  33. which are run from the DOS command line. To do this you must first compile
  34. your program using BC's /O switch, eg:
  35.  
  36.     BC /O YOURPROG.BAS;
  37.  
  38. where YOURPROG.BAS is, of course, the name of your program. 
  39.  
  40. The resulting object file should then be linked to the library using the
  41. version of LINK.EXE which came with your QuickBASIC compiler, viz:
  42.  
  43.     LINK YOURPROG,,,ALTQUICK.LIB;
  44.  
  45. This will produce an executable program, YOURPROG.EXE, which can be run
  46. completely stand-alone, without the need for the QuickBASIC support module
  47. BRUN45.EXE to be present at runtime. It can, therefore, be distributed
  48. freely without the need for royalty payments.
  49.  
  50.  
  51. ALTQUICK.QLB, the second version of the library, is used for developing
  52. programs in the QuickBASIC environment. To load it, use the following
  53. command when starting up QuickBASIC:
  54.  
  55.     QB YOURPROG /L ALTQUICK.QLB
  56.  
  57. Thereafter your program can call any of the Toolbox functions and
  58. procedures, provided that it includes the appropriate DECLARE statements
  59. at the beginning of its' code.
  60.  
  61. DECLARE statements are prototype descriptions of the SUB programs and
  62. FUNCTION procedures which your program will call. The QuickBASIC compiler
  63. uses them to determine the number of arguments that need to be passed and
  64. how the routines are to be called. Once declared, a library routine needs
  65. only to be named for it to be executed and becomes, in effect, an
  66. extension to the QuickBASIC language.  To use the Toolbox FASTPRINT
  67. routine, for example, add the following lines to your program:
  68.  
  69. DECLARE SUB FastPrint (BYVAL Row%, BYVAL Col%, Message$, BYVAL Attribute%)
  70.  
  71. FastPrint 25, 34, "Hello World!", 48
  72.  
  73. This will print 'Hello World!' at the centre of the bottom screen row,
  74. using black characters on cyan background (assuming that you have a colour
  75. monitor).  Notice that you don't even have to use a CALL statement to
  76. invoke FastPrint and that the parentheses around the argument list are not
  77. required.
  78.  
  79. DECLARE statements have another use when you are building stand-alone
  80. programs with LINK.EXE. They tell the linker to attach only the modules
  81. containing the declared library routines to your program, and no others.
  82. This helps keep your .EXE files smaller by preventing them from being
  83. burdened with unneccessary code. The file ALTQUICK.DEF contains a full
  84. set of DECLARE statements for all the library routines on this disk. 
  85. Just paste the ones you need into your current program.
  86.  
  87. If you have been using a previous version of the Toolbox, please note that
  88. many of the DECLARE statements for previously existing routines have been
  89. changed. In particular, a number of arguments which were previously passed
  90. by reference are now passed BY VALue. Others have been given additional
  91. parameters. Before you link existing code to the new version of
  92. ALTQUICK.LIB, you should check with ALTQUICK.DEF that your DECLARE
  93. statements are still valid.
  94.  
  95. The \HELP subdirectory contains a number of ASCII topic files which are
  96. used by DEMON.EXE, the Toolbox demonstration program, to provide context-
  97. sensitive help. If you are copying the Toolbox package to your hard disk,
  98. be aware that not all of these are visible to normal directory listings
  99. (see the HELPMATE documentation for more information). You may also need
  100. to set up a DOS environment variable to point to the subdirectory you
  101. transfer the topic files to, otherwise DEMON may not find them, eg:
  102.  
  103.     SET HELP=C:\QB45\HELPTEXT
  104.  
  105. With this release I have also provided the source code for DEMON as a
  106. guide to using Toolbox routines in your own programs. Feel free to copy
  107. or modify any part of it as you see fit.
  108.  
  109.  
  110. This ShareWare version of the Assembly-Language Toolbox for QuickBASIC is
  111. provided, free of charge, to any QuickBASIC programmer who can find a use
  112. for it. You are encouraged to copy it, upload it to Electronic Bulletin
  113. Boards or pass it on to friends, provided only that you make no charge for
  114. doing so and that all the files on the disk are preserved intact. You may
  115. freely include Toolbox routines in your own programs, both for private use
  116. and for commercial distribution, without payment to me.
  117.  
  118. If you intend to use the Toolbox on a regular basis, however, I would ask
  119. you to register your copy with me, the author. For a modest fee, this will
  120. bring you a copy of the Professional version of the Toolbox, complete with
  121. all the source code, object modules for building your own custom libraries
  122. and many additional features. Registration also entitles you to a free
  123. upgrade to Release 6 of the Toolbox, when it becomes available, and to
  124. subsequent releases at a greatly reduced price. Full Hotline support is
  125. also included, at no extra charge. 
  126.  
  127. Christy Gemmell                                              February 1991
  128.  
  129.                 ────────────────────────────────────────────
  130.  
  131.                     For more information contact:
  132.  
  133. James Kreyling      CPC Consulting Company, 1217 Crescent Drive,
  134.                     Smithfield, Va. 23430, U.S.A.
  135.  
  136.           Tel:      (804)-357-9190 (Voice)
  137.                     (804)-357-0357 (Club-PC BBS)
  138.                     (804)-357-9190 (FAX)
  139.  
  140. Christy Gemmell     Apt.13, Beckville Building
  141.                     17 Glebe Street
  142.                     Leicester LE2 0JR, England
  143.  
  144.           Tel:      (044)-0533-540720
  145.  
  146.  
  147. ┌──────────────────────────── F L A S H ! ───────────────────────────────┐
  148. │                                                                        │
  149. │           Assembly-Language Toolbox for Visual BASIC for DOS           │
  150. │                          is now available                              │
  151. │                                                                        │
  152. └────────────────────────────────────────────────────────────────────────┘
  153.  
  154. The Assembly-Language Toolbox for QuickBASIC is used by thousands of
  155. programmers in Great Britain, Europe, the USA and Canada, Australasia and
  156. Japan, to build fast and powerful QuickBASIC programs. It has been shown
  157. at COMDEX and was featured in the November 1990 issue of BYTE magazine.
  158.  
  159. Christy Gemmell, the author of this package, is also major author of the
  160. definitive textbook on QuickBASIC programming, the QuickBASIC BIBLE, which
  161. is published by Microsoft Press, in association with the Waite Group, at
  162. £24.95 ($27.95 US) ISBN 1-55615-262-0. Its thousand pages are packed with
  163. information, tips and example programs which you wont find anywhere else.
  164. Look out for it in your local bookstore.
  165. 
  166.